home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / gemfst15.lzh / GEMF_V15.DOC < prev    next >
Encoding:
Text File  |  1990-06-29  |  10.2 KB  |  241 lines
  1.  
  2.  GEMFAST v1.50.
  3.  06/29/90 by Ian Lepore.
  4.  
  5.  Version 1.50 of GemFast is a full release of the GemFast bindings.
  6.  
  7.  In GEMFST15.ARC you will find new new libraries (VDIFAST.A and AESFAST.A),
  8.  & new docs; see packing list in GEMFBIND.DOC for a full list of contents.
  9.  
  10.  A new set of example programs was co-released with this version of 
  11.  GemFast.  Look for GEMFXM14.ARC at your favorite PD software outlet.
  12.  
  13.  A new version of the non-standard utilties in C source code form was
  14.  co-released with this version of GemFast.  Look for GEMFUT14.ARC.
  15.  
  16.  The source code for this release of the bindings can be found in the
  17.  file GEMFSC15.ARC.
  18.  
  19.  All GemFast-related files can be found on BIX, in atari.st/listings.
  20.  
  21.  The primary reasons for this release are:
  22.     - The utilities document file (GEMUTIL.DOC) was missing from the 
  23.       v1.4 release file.
  24.     - Added VDI function v_gchar() to output a single character via
  25.       v_gtext().  Documented in GEMXTEND.DOC.
  26.       
  27.  INSTALLING THIS RELEASE:
  28.  
  29.   (Detailed instructions for a first-time install are in GEMFBIND.DOC)
  30.  
  31.   Throw away the following files from your current release:
  32.  
  33.       AESFAST.A    VDIFAST.A    GEMFAST.H    
  34.       AESFAST.NDX  VDIFAST.NDX  (optional...used only with the aln linker)
  35.       All documentation files.
  36.       
  37.   Install the following files from the ARC:
  38.  
  39.     AESFAST.A    VDIFAST.A     GEMFAST.H    
  40.     All DOC files.
  41.  
  42.  If you are using the Atari 'aln' linker, be sure to create new .NDX files
  43.  by running the DOINDEX utility against the new bindings (.a files).
  44.  
  45. ;*************************************************************************
  46. ; GEMFAST v1.50 notes.
  47. ;*************************************************************************
  48.  
  49. Summary of changes to the bindings:
  50.  
  51.  - Added VDI function v_gchar().  This allows a very fast call to v_gtext()
  52.    to output a single character.  Documented in GEMXTEND.DOC.
  53.    
  54. ;*************************************************************************
  55. ; GEMFAST v1.40 notes.
  56. ;*************************************************************************
  57.  
  58. Summary of changes to the bindings:
  59.  
  60.  - Several alternate bindings have been added (listed above).  These are
  61.    documented in GEMXTEND.DOC.
  62.  
  63.  - The fsel_14input() function was added.  This is a no-emulation version
  64.    of the TOS 1.4 fsel_exinput() function.  If TOS 1.4 is available, the
  65.    fsel_exinput function is called, else the old fsel_input is called.
  66.  
  67. Summary of changes to the GEMFAST.H file:
  68.  
  69.  - The constants AESUTIL_A, AESFAST_A, and VDIFAST_A have been added.  
  70.    This allows full compile-time check of the runtime environment.
  71.    
  72.  - All elements in structures which were defined as 'long' but were 
  73.    really pointers to something are now defined as the appropriate type
  74.    of pointer.  This is gonna cause some existing code to break, but it
  75.    is about time to clean up this DRI-originated stupidity.  If your 
  76.    compiler is smart enough to warn you about pointer type mismatches,
  77.    you can clean up your existing code in just a few minutes. (And if your
  78.    compiler doesn't complain about mismatches, you're already all set.)
  79.    Comments in GEMFAST.H describe these pointer changes in more detail.
  80.  
  81.  - Added RSHDR structure for embedded RSC file support.
  82.  
  83. Summary of changes to the non-standard utilities:
  84.  
  85.  - The rsc_gstrings()/rcs_sstrings() functions now support ICON objects.
  86.  
  87.  - Added obj_rbselect() function.  This function deselects the current 
  88.    radio button in a group and selects a new one.  
  89.    
  90.  - Added obj_xtfind() function.  This function find an object with a given
  91.    extended object type within a tree/subtree.
  92.  
  93. ;*************************************************************************
  94. ; GEMFAST v1.30 notes.
  95. ;*************************************************************************
  96.  
  97. Summary of changes to the GEMFAST.H file:
  98.  
  99.  - The constant GEMFAST_H is now #define'd to 1.  This allows C source code
  100.    to detect whether the GEMFAST system is in use (and perhaps conditionally
  101.    include code for the utilties that may not be present under other
  102.    bindings systems).
  103.  
  104.  - Several new constants have been added to provide compatibility with MWC.
  105.    (EG, MWC uses ROOT instead of R_TREE, both are now defined).  Changes of
  106.    this nature should be transparent to existing applications, unless one
  107.    of the new constants conflicts with a name being used by the application.
  108.    
  109.  - The constants defining the VDI interior styles & patterns were originally
  110.    defined as IP_HOLLOW, etc, in the GEMDEFS.H file.  I had renamed these to
  111.    VIP_HOLLOW, etc, for GEMFAST.H.  At the request of several users, I've
  112.    added the old names back in.  The VIP_????? names will go away eventually.
  113.    The names of the object colors have also been added back in.
  114.    
  115.  - Lots of #define statements have been added to support the old names of
  116.    utility functions which have been renamed within the bindings.
  117.  
  118. Summary of changes to the non-standard utilities:
  119.  
  120.  - Routine objcl_calc() is in the process of being phased out.  Don't
  121.    use it any more.
  122.    
  123.  - Many of the utility functions have been renamed.  The old names will
  124.    continue to be supported for some time via #define statements in the
  125.    GEMFAST.H file.  Full details on this are available in GEMUTIL.DOC, the
  126.    following is a summary of the renaming:
  127.    
  128.      objclg_adjust renamed to rc_gadjust.
  129.      objclv_adjust renamed to rc_vadjust.
  130.      objc_xywh     renamed to obj_xywh.
  131.      objrb_which   renamed to obj_rbwhich.
  132.      objst_change  renamed to obj_stchange.
  133.      objfl_change  renamed to obj_flchange.
  134.      graqon_mouse  renamed to gra_qonmouse.
  135.      graqof_mouse  renamed to gra_qofmouse.
  136.      graq_mstate   renamed to gra_qmstate.
  137.  
  138.  - A couple of new utility functions were formalized in this release:
  139.  
  140.      obj_rbfind  - find child object in a given state (eg, radio button).
  141.      obj_offxywh - get screen-adjusted x/y/w/h of object.
  142.  
  143. Summary of AES bindings changes in v1.30:
  144.  
  145.  - Fixed the emulation mode of fsel_exinput when running on a pre-TOS 1.4
  146.    system.  The emulation would die, 2 bombs, if run on a pre-1.4 system,
  147.    AND NOBODY REPORTED IT FOR OVER 6 MONTHS!  I finally discovered it 
  148.    myself when testing an application for 1.0 compatibility.  This tells
  149.    me that NOBODY is using this function, but that's cool, I'm gonna keep
  150.    supporting it anyway.
  151.    
  152. Summary of VDI bindings changes in v1.30:
  153.  
  154.  - Fixed a problem with vsl_ends().  The binding was coded to DRI specs,
  155.    but the DRI docs don't mention that the function returns 2 integers.
  156.    Since the DRI docs make no provisions for returning these values through
  157.    the binding, the fix simply prevents the bombs; the values are still not
  158.    returned to the calling application.
  159.  
  160. ;*************************************************************************
  161. ; GEMFAST v1.20 notes.
  162. ;*************************************************************************
  163.  
  164. Summary of AES bindings changes in v1.20:
  165.  
  166.  - The 'quick' mouse functions graqon_mouse(), graqof_mouse(), and
  167.    graq_mstate() were fixed to work under all TOS versions.
  168.    
  169.  - The shel_get() and shel_put() functions were implemented as described
  170.    in the TOS 1.4 release notes (see docs in GEMXTEND.DOC).
  171.  
  172.  - Another emulation version of fsel_exinput() was added.  This version
  173.    emulates the prompt feature only, beyond that it is identical to the
  174.    TOS 1.0 fsel.  This one is only half the size of the full emulation.
  175.    (Documented under fsel_smallexinput() in GEMXTEND.DOC).
  176.  
  177.  - A lot of the source modules were split into smaller modules containing
  178.    less functions.  This makes the library bigger, but might make your
  179.    programs a bit smaller, as there will be less tendancy to include 
  180.    pieces of the bindings that your program will never use.
  181.  
  182.  - A TST.W D0 instruction was added to the common return-to-user routine
  183.    so that the flags in the CCR will match the return value in register d0.
  184.    This is needed because the Laser C compiler assumes it will be so, and
  185.    will not generate TST.x instructions inline under some circumstances,
  186.    such as when a call is coded as "if (!rsrc_load(filename))".
  187.  
  188.  - A TST.W D0 (or equivelent) was also added to all the utility routines
  189.    which are not defined as type 'void'.
  190.  
  191. Summary of VDI bindings changes in v1.20:
  192.  
  193.  - A bug in v_contourfill() was fixed (call no longer causes 3 bombs).
  194.  
  195.  ; end of docs for v1.2
  196.  
  197. ;*************************************************************************
  198. ; GEMFAST v1.10 notes.
  199. ;*************************************************************************
  200.  
  201. Summary of AES bindings changes in v1.10:
  202.  
  203.  - A global variable was added to AES@NOTE such that the version number is 
  204.    part of the variable name.  Allows a quick version-check via a link map.
  205.  
  206.  - New TOS 1.4 function 'wind_new()' added (see GEMXTEND.DOC).
  207.  
  208.  - New TOS 1.4 function 'fsel_exinput()' (see GEMXTEND.DOC).
  209.  
  210.  - 'Undocumented' functions 'form_button()' and 'form_keybd()' added
  211.     (see GEMXTEND.DOC).
  212.  
  213.  - Some cleanup in AESCOMN.S.
  214.  
  215.  - All of the variables in the 'global' array now have unique global 
  216.    names which can be accessed from C (see GEMFBIND.DOC section 6.0).
  217.  
  218.  The AESFAST.A file is much bigger than v1.0.  This is primarily due to 
  219.  the addition the new fsel_exinput function (see below), and the vast
  220.  amount of code required to simulate its actions on pre-TOS 1.4 systems.
  221.  If you don't use this function, the increase in size won't affect you.
  222.  
  223. Summary of VDI bindings changes in v1.10:
  224.  
  225.  - A global variable was added to VDI@NOTE such that the version number is 
  226.    part of the variable name.  Allows a quick version-check via a link map.
  227.    
  228.  - Misnamed function vq_extend was renamed to vq_extnd in VDIINQR1.S
  229.  
  230.  - The stack parms for vq_extnd were wrong, now fixed.
  231.  
  232.  The VDIFAST.A file is slightly smaller.  This is due to a change in the
  233.  way I build the library.  Instead of adding everything to the library,
  234.  then running the Sozobon GLOBS program to remove non-global symbols from
  235.  the files, I ran GLOBS on each file individually before adding it to the
  236.  library.  I didn't expect any difference, and I don't know why there is
  237.  one, but since it made the library smaller I'm not complaining.
  238.  
  239.  ; end of doc.
  240.  
  241.